using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using UwinEducation.Application.Dtos.Descriptions;
using UwinEducation.Shared.Enums;
using UwinEducation.Shared.Models;

namespace UwinEducation.Application.Common.Interfaces
{
    /// <summary>
    /// 描述管理服务接口
    /// </summary>
    public interface IDescriptionService
    {
        /// <summary>
        /// 获取描述详情
        /// </summary>
        /// <param name="id">描述ID</param>
        /// <returns>描述DTO</returns>
        Task<DescriptionDto> GetByIdAsync(Guid id);

        /// <summary>
        /// 根据类型获取描述列表
        /// </summary>
        /// <param name="type">描述类型</param>
        /// <returns>描述DTO列表</returns>
        Task<List<DescriptionDto>> GetByTypeAsync(DescriptionType type);

        /// <summary>
        /// 根据标题模糊查询
        /// </summary>
        /// <param name="title">标题关键字</param>
        /// <returns>描述DTO列表</returns>
        Task<List<DescriptionDto>> GetByTitleAsync(string title);

        /// <summary>
        /// 分页查询描述
        /// </summary>
        /// <param name="request">分页请求</param>
        /// <returns>分页结果</returns>
        Task<PagedResult<DescriptionDto>> GetPagedAsync(DescriptionPageRequest request);

        /// <summary>
        /// 创建描述
        /// </summary>
        /// <param name="createDto">创建描述DTO</param>
        /// <returns>描述DTO</returns>
        Task<DescriptionDto> CreateAsync(CreateDescriptionDto createDto);

        /// <summary>
        /// 更新描述
        /// </summary>
        /// <param name="updateDto">更新描述DTO</param>
        /// <returns>描述DTO</returns>
        Task<DescriptionDto> UpdateAsync(UpdateDescriptionDto updateDto);

        /// <summary>
        /// 删除描述
        /// </summary>
        /// <param name="id">描述ID</param>
        Task DeleteAsync(Guid id);
    }
} 